PHOTOSHOP · 使用指南

YCraft PS插件使用指南

选择插件，直接操作面板；在示例画布和图层中查看结果。

选择「完整动画」可观看操作过程。

PSD清理

先选项目，再执行。用示例观察保存、检测、暂停确认，以及档内清理与深清重开的区别。

清理 0.5.8：重绘预检与无修改时跳过保存

先检查重绘是否稳定。档内清理先在临时完整图层副本上检查重复渲染。如果原样重绘也会改变像素，就提前保留内嵌对象及其元数据，并在运行记录中说明原因；可再选择深清直接处理文件元数据。

回写仍逐分支检查。稳定渲染的文档继续精确比较回写前后像素，发现变化时恢复该分支。常规历史恢复校验失败后会尝试完整快照；快照恢复可能截断更早的历史。恢复仍失败则停止后续处理与最终保存。

没有内容可清理，就不重复保存。其他清理项先检查，有实际修改才创建相应历史步骤并保存，避免深清后空操作又生成元数据。图层样式仅清理关闭的效果，保留开启效果、不透明度、填充和混合模式。

已修复旧版 CEP 中部分文件深清出现的 overlapping_edits 错误。部分 PSD 原样重开也会有轻微重绘差异，不能把深清理解为保证重开后的实时画面绝对一致。

下方动画只演示常见操作流程，不模拟像素校验、快照恢复或无修改时跳过保存；实际处理与跳过情况请看运行记录。

尚未执行
教程只操作虚拟示例，不读写你的文件。

可操作教程面板 · 示例文件

查看模式区别、清理规则与保存说明

0.5.8：先选清理项目，再点击底部按钮。两个元数据模式互斥，也可都不选；智能对象栅格化入口已移除。

两个元数据模式，怎么选？

元数据·档内清理

主文档保持打开。先处理主文档，再按元数据量从大到小进入可处理的内嵌智能对象，逐级保存；共享内容成功处理后跳过重复实例。

尽量保留历史，但元数据和嵌套内容不保证完整撤销。选中图层仅限制内嵌遍历范围，主文档元数据仍整体处理。

元数据·深清重开

仅支持 PSD / PSB。流式清理整份文件及可解析内嵌文档的 XMP、IPTC 和摘要，不逐个打开智能对象；校验通过后替换或打开新副本。

重开后旧历史重置，再执行其他勾选项目，保留一个图层清理撤销步骤；最后保存，不再次重开。此模式禁用“清理选中图层”。

两种模式都保留智能对象可编辑结构。外部链接、不支持或无法解析的内容可能跳过；查看运行记录。保存时 Photoshop 可能重新生成基础信息。

检测、推荐与暂停确认
  1. 单独点击“检测”只读取磁盘已保存版本，不保存、不清理。未保存修改不计入。
  2. 点击清理后，先自动保存，再重新检测。首次未保存的文档需要选择保存位置；保存失败或取消时不开始清理。
  3. 元数据总量 ≥128 MiB 或单处 ≥64 MiB 时建议深清。这是初始参考值，不是耗时或效果保证；推荐不会自动改模式。
  4. 档内模式遇到深清推荐时先暂停，尚未执行任何清理。切到深清后再点击清理，或保持档内模式点击“继续文档内清理”。
  5. 文件、文档、选中范围或选项变化后会重新确认。批量继续保留剩余队列，已完成文件不重复处理；每个需要推荐的文件分别确认。

在右侧将示例文件切到“元数据较多的 PSD”，即可体验暂停和继续。

其他四项清理规则
选项会改哪里
画布外删除完全在画布外的内容图层；部分越界、调整层保留。含画板或无法确认画板状态时跳过。
隐藏图层删除隐藏图层及隐藏组；隐藏组包含的子图层一并删除。
空白图层删除空组和零尺寸普通像素层；不按零尺寸规则删除调整层等特殊类型。
图层样式移除关闭的样式，保留开启的样式；整组效果关闭时移除整组，支持图层组。

首次默认开启档内元数据、画布外、隐藏和空白图层；深清与图层样式默认关闭。没有选择任何项目时不保存、不执行。

副本、覆盖、批量与取消
  • 所有项目都先自动保存输入文档当前修改。副本模式不代表原文档的未保存修改不会写入磁盘。
  • 默认副本：档内模式另存 文件名_cleaned；深清另存 文件名_metadata_cleaned。同名副本递增编号，原文档保留。
  • 覆盖：写回原文件。深清替换不保留额外备份，重开后旧历史重置。覆盖开关每次重载面板恢复关闭。
  • 批量：原本打开的文档保留；本次打开的文件及输出副本处理后关闭。仅深清元数据时，原本关闭的文件不必打开；叠加图层清理时需打开处理。关闭后的文档不保留撤销历史。
  • 点击“取消清理”或面板内按 Esc 请求停止。单次打开或保存可能要等结束；已完成的修改和先前保存的批量文件不回滚。
  • 深清若已开始替换，会先完成替换或恢复并重开，再停止后续项目。保存失败时保留结果文档，查看运行记录后手动处理。
首次使用 · 安装与打开

保存文件并退出 Photoshop，双击 YCraft 插件安装器 EXE，点击「安装 / 更新」。完成后打开 PS，从「窗口 → 扩展功能」或「扩展功能（旧版）」打开三个 YCraft 面板。无需解压；HTML 教程单独提供。

面板名称依次为「YCraft 清理」「YCraft 导出」「YCraft 标注」。更新后完整关闭再打开面板。菜单未出现时，先保存工作，再自行重启 Photoshop。

完整文字参考 · 功能规则与常见问题

三个插件如何配合使用

这三个插件分别用于整理 PSD、输出图片素材和制作设计标注。日常交付时，建议先保留源稿，在副本中清理多余内容，再导出素材，最后补充尺寸与样式说明。本教程适合需要整理设计文件、切图或向开发人员交付设计稿的用户。

教程名称PS 中的面板名称主要用途
YCraft 清理YCraft 清理清理多余图层和文档信息
YCraft 导出YCraft 导出批量切图、多倍率导出与文字拆分
YCraft 标注YCraft 标注标注尺寸、距离、颜色及导出交付页面

安装和打开

  1. 保存文件并退出 Photoshop，双击 YCraft 插件安装器 EXE，点击「安装 / 更新」。旧版自动备份，安装后再打开 PS；不会自动关闭或重启 Photoshop。
  2. 在 Photoshop 的「窗口 → 扩展功能」中，选择上表对应的面板名称。
  3. 更新后完整关闭面板，再从窗口菜单重新打开。仅收起面板不算重新加载。
  4. 初次安装后没有菜单，或仍显示旧版本时，先保存工作，再在空闲时自行重启 Photoshop。

开始前先确认

  • 处理对象：确认当前活动文档、选中图层和导出目录，首次使用建议在 PSD 副本中操作。
  • 版本范围：本教程对应 YCraft 清理 0.5.8、YCraft 导出 0.2.7、YCraft 标注 0.2.22。
  • 运行环境：已有验证记录主要来自 Windows 与 Photoshop 2020 21.2.3。其他 Photoshop 版本需另行确认兼容性。

YCraft 清理 · 0.5.8

清理 0.5.8 使用要点

先检查重绘是否稳定。档内清理先在临时完整图层副本上检查重复渲染。如果原样重绘也会改变像素，就提前保留内嵌对象及其元数据，并在运行记录中说明原因；可再选择深清直接处理文件元数据。

回写仍逐分支检查。稳定渲染的文档继续精确比较回写前后像素，发现变化时恢复该分支。常规历史恢复校验失败后会尝试完整快照；快照恢复可能截断更早的历史。恢复仍失败则停止后续处理与最终保存。

没有内容可清理，就不重复保存。其他清理项先检查，有实际修改才创建相应历史步骤并保存，避免深清后空操作又生成元数据。图层样式仅清理关闭的效果，保留开启效果、不透明度、填充和混合模式。

已修复旧版 CEP 中部分文件深清出现的 overlapping_edits 错误。部分 PSD 原样重开也会有轻微重绘差异，不能把深清理解为保证重开后的实时画面绝对一致。

下方动画只演示常见操作流程，不模拟像素校验、快照恢复或无修改时跳过保存；实际处理与跳过情况请看运行记录。

0.5.8：先选清理项目，再点击底部按钮。两个元数据模式互斥，也可都不选；智能对象栅格化入口已移除。

两个元数据模式，怎么选？

元数据·档内清理

主文档保持打开。先处理主文档，再按元数据量从大到小进入可处理的内嵌智能对象，逐级保存；共享内容成功处理后跳过重复实例。

尽量保留历史，但元数据和嵌套内容不保证完整撤销。选中图层仅限制内嵌遍历范围，主文档元数据仍整体处理。

元数据·深清重开

仅支持 PSD / PSB。流式清理整份文件及可解析内嵌文档的 XMP、IPTC 和摘要，不逐个打开智能对象；校验通过后替换或打开新副本。

重开后旧历史重置，再执行其他勾选项目，保留一个图层清理撤销步骤；最后保存，不再次重开。此模式禁用“清理选中图层”。

两种模式都保留智能对象可编辑结构。外部链接、不支持或无法解析的内容可能跳过；查看运行记录。保存时 Photoshop 可能重新生成基础信息。

检测、推荐与暂停确认
  1. 单独点击“检测”只读取磁盘已保存版本，不保存、不清理。未保存修改不计入。
  2. 点击清理后，先自动保存，再重新检测。首次未保存的文档需要选择保存位置；保存失败或取消时不开始清理。
  3. 元数据总量 ≥128 MiB 或单处 ≥64 MiB 时建议深清。这是初始参考值，不是耗时或效果保证；推荐不会自动改模式。
  4. 档内模式遇到深清推荐时先暂停，尚未执行任何清理。切到深清后再点击清理，或保持档内模式点击“继续文档内清理”。
  5. 文件、文档、选中范围或选项变化后会重新确认。批量继续保留剩余队列，已完成文件不重复处理；每个需要推荐的文件分别确认。

在右侧将示例文件切到“元数据较多的 PSD”，即可体验暂停和继续。

其他四项清理规则
选项会改哪里
画布外删除完全在画布外的内容图层；部分越界、调整层保留。含画板或无法确认画板状态时跳过。
隐藏图层删除隐藏图层及隐藏组；隐藏组包含的子图层一并删除。
空白图层删除空组和零尺寸普通像素层；不按零尺寸规则删除调整层等特殊类型。
图层样式移除关闭的样式，保留开启的样式；整组效果关闭时移除整组，支持图层组。

首次默认开启档内元数据、画布外、隐藏和空白图层；深清与图层样式默认关闭。没有选择任何项目时不保存、不执行。

副本、覆盖、批量与取消
  • 所有项目都先自动保存输入文档当前修改。副本模式不代表原文档的未保存修改不会写入磁盘。
  • 默认副本：档内模式另存 文件名_cleaned；深清另存 文件名_metadata_cleaned。同名副本递增编号，原文档保留。
  • 覆盖：写回原文件。深清替换不保留额外备份，重开后旧历史重置。覆盖开关每次重载面板恢复关闭。
  • 批量：原本打开的文档保留；本次打开的文件及输出副本处理后关闭。仅深清元数据时，原本关闭的文件不必打开；叠加图层清理时需打开处理。关闭后的文档不保留撤销历史。
  • 点击“取消清理”或面板内按 Esc 请求停止。单次打开或保存可能要等结束；已完成的修改和先前保存的批量文件不回滚。
  • 深清若已开始替换，会先完成替换或恢复并重开，再停止后续项目。保存失败时保留结果文档，查看运行记录后手动处理。

YCraft 导出 常用切图

导出 0.2.7 更新

切图以所属画板为边界。规则批量导出的单项 PNG 先按所属画板裁切；没有画板时按文档画布裁切，再去掉透明边缘。画布外的图形和投影不会进入图片，完全在外或范围内没有像素的项会记为失败，不生成空白图。

例如原图层宽 1406px、所属画板宽 1080px，超出左右边界的部分不进入切图；若画板内还有透明边缘，最终图片还会继续裁边。匹配规则、组整体导出、命名与同名覆盖方式保持一致。

导出前读取更轻。手动切图减少对整份 PSD 和复杂图层边界的重复读取，改善部分大型文件在准备阶段等待过久的问题。操作步骤不变：选图层 → 选格式／倍率 → 选目录 → 导出。

处理期间等当前任务完成，再执行下一次导出。不同文件的实际耗时仍会变化。

YCraft 导出将多种素材输出方式集中在「YCraft 导出」面板中。顶部菜单用于切换功能，底部统一选择导出目录；右上角「…」可设置输出参数、预设和查看运行记录。初始首页为「规则批量导出」；0.2.7 可在顶部菜单拖动排序，下次以第一项为首页。

教程一 按名称批量导出

  1. 将待导出图层或组命名为「界面_类型_名称」，例如 login_img_button。
  2. 在「编辑类型标签」中确认 img 已包含在类型列表中；匹配依据是名称中第二段的类型标签。
  3. 选择导出目录，点击「扫描预览」，核对识别到的对象及数量。
  4. 选择「只导出切图」「只导出效果图」或「切图和效果图」，再点击「开始批量导出」。

命名提示：匹配到图层组后，会把该组作为一个整体导出，不再重复导出组内子图层。要分别导出子元素，应避免父组先命中规则。

教程二 手动导出选中图层

  1. 从顶部切换到「手动切图」，在 Photoshop 中选中一个或多个图层。
  2. 选择 Web、iOS 或 Android，再选择所需格式或倍率。格式可多选，切换平台后其他平台的已选项仍会保留。
  3. 需要多层合成一张图时，勾选「合并选中的图层」并填写合并文件名；不勾选则分别输出。
  4. 设置输出目录，点击「导出选中图层」，打开输出文件夹检查尺寸、透明边和效果。
需要的结果建议设置
透明素材使用 PNG；通常选择 PNG-24 保留完整色彩。
多倍率交付选择对应平台的倍率；额外倍率可在「自定义输出」中添加。
指定画布大小填写宽高，内容居中补边；内容过大时等比缩小。
保留原画板范围在「透明边缘」中选择保留画板／文档尺寸。

同名文件：手动切图默认覆盖输出目录中的同名文件，可在更多选项中改为「自动加序号」。同一次任务中多个同名图层会自动加序号。手动设置不会改变规则批量导出的设置。

YCraft 导出 进阶功能

标注 0.2.22 使用要点

新增批量标注：识别 → 核对 → 勾选 → 生成。点面板顶部「手动标注」切换到「批量标注」，识别全部可见画板中的命名资源与独立文字。默认推荐项已勾选；待确认项默认不选，重复资源省略，混合样式文字请手动处理。请先核对清单，自动识别不能代替人工判断。

生成什么，沿用什么。图片标左上角坐标，矩形／背景增加宽高，文字增加字体、字号和颜色；沿用当前文字、标线及文字信息位置设置。命名组作为整体，重复列表默认取一行。不是每个图层都会自动标注。

可以中途停止，也能分项撤销。点「完成当前项后停止」会先完成正在处理的一项；已完成标注保留，每项可独立撤销。修改图层或切换文档后需重新识别；已生成项再次识别时会跳过，删除结果后可重新生成。插件不会自动保存 PSD。

自动导出有进度，也支持停止。逐画板整理图层、生成预览并分块写入，全部完成才替换目标 HTML。中途停止保留原目标文件；只复制当前画板，保留预览透明边距。切换顶部模式即可在下方演示。

智能对象、蒙版和剪贴按可见范围测量。在临时副本中合成测量后清理副本，原智能对象仍可编辑。父组带蒙版时可能计入同组其他可见内容；需要量局部可先建选区。合法的负坐标不会强行归零。连续标注会复用画板范围，编辑、撤销／重做或切换文档后重新测量。

保留原有操作习惯。标注内部组生成后自动收起，外层总组保持展开；本次标注之间建立链接，不链接原图层。文字说明支持多行、位置选择与 2000 字符计数。下方仅为离线示例，不读取 PSD，不实际生成文件；真实测量和处理速度以 Photoshop 为准。

文字拆分导出

适合将数字、单词或带效果的文字拆成独立 PNG。每个单词放在一个顶层图层组中；这个流程会调整文字和图层结构，建议在专用副本中操作。

  1. 字距：点击「扫描并应用字距」，默认值为 1000。检查字符及投影之间是否留有间隙。已有进度可先点击「读取进度」。
  2. 合并：点击「备份并合并文字组」。插件保留隐藏的 backup_ 备份，并把原组合并为像素图层。
  3. 检测：点击「检测全部字符边界」。默认灵敏度 0、最小间隙 4、扫描步长 2；边界不合适时调整后重新检测。
  4. 拆分：点击「拆分并重命名」，按检测边界生成字符图层。切换文档或改变相关内容后，应重新读取或检测。
  5. 导出：选择普通、只有数字等高或全部等高，点击「导出字符切图」。等高仅补充纵向透明范围，不拉伸字符；按原组名创建子目录，同名文件覆盖。

注意：关闭重开面板后，尚未拆分的图层需要重新检测。当前合并版文字流程已有独立逻辑测试，最终像素输出仍需在实际素材上验收。

参考线切图

  1. 在 Photoshop 中放好横向和纵向参考线，再切换到「参考线切图」。
  2. 选择「选中的图层」或「整个文档」，再选择 PNG 或 JPG，可填写文件名前缀。
  3. 点击「预览分割数量」核对范围，然后点击「开始切图」。

选中多个图层时会逐层分割。分块保留完整矩形范围，不自动裁掉块内透明边。默认编号按从左到右、每列从上到下的顺序生成。

自动九宫处理

先把待处理 PNG 复制到独立文件夹，切换到「自动九宫处理」，选择处理目录后点击「开始九宫处理」。它识别可重复区域并保留 8px 安全边距，完成后会覆盖目录中的原 PNG；运行依赖系统可用的 node 命令。

功能边界：自动九宫处理不是带边缘黑线标记的点9输出。GIF 为静态图；JPG 和 BMP 不支持透明背景；SVG 转换不会把位图变成真正矢量。点9切图、APP 图标切图及图片分割切图尚未加入当前可用流程。

YCraft 标注

YCraft 标注在「YCraft 标注」面板中使用，可生成尺寸、位置、距离、颜色和文字说明。标注文字及标线放入「YCraft 标注」图层组，能够单独编辑；每项工具右侧的小箭头可选择方向或处理方式。

常用教程 为一个按钮制作标注

  1. 打开 RGB 设计稿，在设置中选择单位、字号、线宽和颜色格式。常规界面交付可先用 px 和 HEX。
  2. 选中按钮图层或组，展开「元素尺寸」，选择「宽度和高度」。有活动选区时会优先标注选区，测图层前先取消不需要的选区。
  3. 需要位置时，使用「边角坐标」选择相应角点。画板内默认以所属画板左上角为原点；需要全稿坐标时勾选「使用整个文档坐标」。
  4. 同时选中按钮和相邻元素，用「相互距离」标注水平或垂直间距。只选一个图层时，可标注到画布或画板边缘的距离。
  5. 选中文字层，用「图层文字」标注所需字段；用「文字说明」补充状态或交互要求。检查遮挡后，调整标注位置。
工具常见用法
手动量距处理已有标尺测量线，或标注选区尺寸。
图层文字选择字号、颜色等信息字段，也可仅提取文字内容。
颜色取样标注最新或全部已有取样点，按设置输出颜色格式。
标参考线标注图层边界或已有参考线，也可沿图层边缘添加参考线。
文字说明与图层遮罩添加方向说明或引线；增加独立遮罩，突出展示区域。

管理与更新标注

「隐藏/显示标注」和「删除标注」只处理本插件生成的内容，操作可撤销。标线和遮罩是可编辑形状层，文字是文字层。源图层内容或尺寸改变后，需要重新生成相关标注；「链接标注图层」只链接同一次生成的标注文字、标线和背景，不链接原图层，也不自动重算数值。既有 PSD 的旧链接不会自动解除。

自动操作提示：拖标尺、取样或拖入参考线后的自动事件尚未完成端到端验收。若没有自动生成，可使用「标注标尺测量线」「标注最后一个取样点」「标注文档参考线」处理已有输入。

导出标注与完成交付

导出 PNG 标注图

  1. 显示需要交付的标注，检查文字是否遮住设计内容，确认数值对应最终版本。
  2. 在手动标注页点击「导出标注」，选择保存位置。PNG 保留当前可见标注；多画板会分别输出图片。

导出离线 HTML 标注页面

  1. 顶部菜单切换到「自动导出标注」，点击「开始导出」并保存 HTML。
  2. 用浏览器打开生成的 HTML，切换画板并点击元素，检查尺寸、位置、文字与颜色信息；支持搜索、缩放和复制。
  3. 把 HTML 文件交付给接收方，可离线查看。自动导出以设计画面与可查询属性为主，不能代替对复杂样式的人工核对。

推荐的交付顺序

保留源 PSD → 在副本中清理 → 导出切图 → 制作标注 → 检查图片与 HTML → 交付。文字拆分建议单独使用副本；自动九宫仅对另存的 PNG 副本执行。

不要在仍需保留隐藏备份时直接清理隐藏图层。例如文字拆分产生的 backup_ 组，以及被隐藏的标注组，都可能被清理插件删除。

常见问题

现象建议检查
找不到插件或界面仍是旧版核对安装是否完成与实际面板名称；完整关闭后重开，必要时保存工作再自行重启 PS。
没有输出或导出对象不对确认活动文档、选中图层、命名类型和输出目录；查看扫描预览及运行记录。
文件被覆盖或数量过多检查同名策略与各平台已选格式；文字导出和自动九宫有各自的覆盖规则。
清理后还有多余内容查看跳过原因。锁定图层、部分越界内容、含画板文档的画布外项可能保留。
标注不准确或信息不完整检查活动选区、坐标原点与单位。设计改动后重新标注；复杂渐变、混合字体等需人工核对。

交付检查：文件能打开，尺寸和倍率正确，透明背景符合预期，文字与效果无明显丢失，标注数值与最终设计一致。